home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / hotdir2.arc / HDIR.DOC < prev   
Encoding:
Text File  |  1987-01-19  |  5.8 KB  |  146 lines
  1.  
  2. HotDIR 1.1 Documentation   -    (c) 1987 by Robert Woeger     1-19-1987
  3. ___________________________________________________________________________
  4.  
  5.  
  6. HotDIR (hot directory) is a user supported software utility I have developed
  7. to help PC users get the most out of their PC monitors.  Unlike most directory
  8. utilities to date, HotDIR uses color extensively to SHOW you your files.
  9. You do NOT need to have a color monitor to use HotDIR (colors will show as
  10. intensities on a monochrome screen), but boy, HotDIR sure makes your directory
  11. HOT on a color system (CGA).
  12.  
  13. HotDIR sorts your files in columns (up and down) and displays different colors
  14. for different types of files (based on their extension).  It supports
  15. pathnames and wildcards also.  At the end of the directory listing, you will
  16. also see the total space on the specified drive, and the space available.
  17.  
  18. The idea for HotDIR (and the name) came from a good friend of mine, John P.
  19. German.  He wanted to make full use of his color monitor, but faced a problem
  20. that the DIR command and his other directory utilities didn't use colors for
  21. displaying text. He asked me to see what I could do for him, and I
  22. subsequently locked myself in my room until I emerged many hours later with
  23. a rough version of what is now HotDIR.  Without his encouragement and
  24. criticisms, I would have never written HotDIR.  Thanks, John.
  25.  
  26. I suggest that you simply run HotDIR, and play around with it.  If you prefer
  27. to read about it, you can continue.  If you are like me, I want to run new
  28. programs without reading the documentation first.  You can't hurt anything by
  29. running HDIR, so give it a try now.
  30.  
  31.  
  32. HotDIR consists of 2 files:
  33.  
  34.     HDIR.COM    The executable program (100% assembly code for speed
  35.             and size).
  36.     HDIR.DOC    This documentation file.
  37.  
  38.  
  39.  
  40. The format for running HDIR.COM is the following:
  41.  
  42.     HDIR [d:\pathname\filename or wildcard]
  43.  
  44.  
  45. where [...] is an optional.  If you do not specify the pathname/filename(s),
  46. HotDIR will use the current directory on the default drive and search for
  47. all files (including hidden, system, and subdirectory files).
  48.  
  49. Examples:
  50.  
  51.     HDIR *.*    Both of these perform the same function
  52.     HDIR        (display all files in the current directory)
  53.  
  54.     HDIR \util\*.*         Displays all files in the subdirectory \util
  55.  
  56.     HDIR \robert\terminal\*.COM    Displays all .COM files in specified dir
  57.  
  58.  
  59.  
  60. The colors displayed for the different file types were chosen after careful
  61. consideration.    We did run out of displayable colors (i.e. those that were
  62. readable enough for text) so we grouped 2 similar categories into the same
  63. color.    Otherwise, each of the file types has its own unique color:
  64.  
  65.     .BAS    -    Green (low intensity)
  66.     .PAS    -    Green (low intensity)
  67.     .DOC    -    Hi White
  68.     .TXT    -    Hi White
  69.  
  70.     .COM    -    Hi green
  71.     .EXE    -    Hi sky blue
  72.     .BAT    -    Hi red
  73.     .ARC    -    Brown
  74.  
  75.     Hidden files    Dark red
  76.     Subdirectories    Magenta (hi purple)
  77.     All other files Gray
  78.  
  79.     All numbers    Yellow
  80.  
  81. Colors really liven up directories, and I'll probably never go back to one
  82. color text directory utilities again.  HotDIR makes it easy to spot a
  83. particular type of file (.BAT for instance) without having to re-sort by
  84. extension, etc.
  85.  
  86.  
  87.  
  88. Technical notes:
  89. ----------------
  90.  
  91.  
  92.  1.  Files larger than ~ 1 megabyte each will have the message "1 Meg+"
  93. in place of the file size.  This is because I have a limited space when
  94. displaying 4 columns of files.    Most people will probably never see this
  95. message because few files today are bigger than 1,000,000 bytes long.
  96.  
  97.  2.  If you get a message saying that the sort area is full, you will
  98. have to remove some files from the directory or get a version of HotDIR from
  99. me that has a bigger sort buffer.  You will only see this if the directory you
  100. request for HotDIR has more than ~245 files.  Again, for most people this
  101. should not be a problem.
  102.  
  103.  3.  HotDIR uses BIOS Video calls to perform most of its display of text.
  104. This is due to the problem people would have using ANSI.SYS to change colors
  105. while running HotDIR.  HotDIR bypasses DOS (and ANSI.SYS) so ANSI.SYS can't
  106. change HotDIRs directory colors.  One restriction on HotDIR is that its output
  107. can't be redirected to a file or other device.  This is because redirection
  108. occurs at the DOS level, not at the BIOS level.
  109.  
  110.  4.  HotDIR works on all 100% IBM PC compatible computers tested.  It was
  111. tested using both the monochrome and color graphics (CGA) display adapters.
  112.  
  113.  5.  MS/PC-DOS Versions 2.1 through 3.2 were tested with HotDIR.
  114.  
  115.  6.  I recommend that you use a good disk cache program when running HotDIR on
  116. a PC with a hard disk.  A cache helps speed up HDIR's disk reading by ~400%.
  117.  
  118.  7.  If the directory that you want HDIR to display has a lot of files on it
  119. and/or the disk is fragmented, HDIR will run slower than normal.  Either use a
  120. disk cache, de-fragment your hard disk, or move some files out of that
  121. directory (the fewer files HotDIR has to sort, the faster it will be).
  122.  
  123.  
  124. _______________________________________________________________________
  125.  
  126.  
  127. Robert Woeger is the author of this and other PC utilities such as PCSTAT.
  128. He has been programming computers for 13 years, and enjoys writing programs
  129. for the PC.  It is through the support of people who use his programs that he
  130. makes his living, and he asks for a $15 donation from satisfied users.  If you
  131. would like to register your copy of HotDIR (and receive a disk with some of
  132. Rob's other programs, plus the latest versions of PCSTAT and HotDIR), send $15
  133. to:
  134.  
  135.                 Rob Woeger
  136.                 P.O. Box FF
  137.                 College Station, TX 77841
  138.  
  139. The $15 includes a disk and shipping.  Thanks for your support.
  140. Please freely share this copy of HotDIR with others and encourage them to
  141. register their copies of HotDIR.
  142.  
  143. Rob welcomes all suggestions, criticisms, and comments about his programs.
  144. Enjoy HotDIR!
  145.  
  146.